markdown语法总结

MarkDown语法总结


目 录

1 标题样式(最多六级)

2 缩进、换行、空行、对齐方式

3 斜体、粗体、删除线、下划线、背景高亮

4 超链接、页内链接、自动链接、注脚

5 无序列表、有序列表、定义型列表

6 插入图片

  • 6.1 使用![]()方式 - 无法确定图片大小

  • 6.2 借用HTMLimg格式 - 能够设置图片大小、居中等

  • 6.3 借用HTML<table>表格 - 实现同行多个图片

7 多级引用

8 转义字符、字体、字号、颜色

9 块语法

10 表格

11 分隔线

12 HTML 原始码

13 特殊字符

参考内容


1 标题样式(最多六级)

  • 1 个 # 表示一级标题(一般一篇文章只有一个一级标题);

  • 2 个 # 表示二级标题;

  • 3 个 # 表示三个标题;
    ……

  • 6 个 # 表示六个标题。


2 缩进、换行、空行、对齐方式

2.1 基本文本输入

文本输入直接在正文打文字即可。

2.2 缩进

不同特殊占位符所占空白不一样,如下:

&emsp;或 &#8195; //全角,1 个汉字
&ensp;或 &#8194; //半角,1/2 个汉字
&nbsp;或 &#160; //半角之半角,1/4 个汉字

2.3 换行(针对 VScode)

2.3.1 同段落换行

在需要换行的文字末尾打上两个空格即可:

这是段落 1 的第一行,后面有两个空格
这是段落 1 的第二行

2.3.2 段落换行

两个段落之间空一行即可;

这是段落 1 的效果,段落 1 与段落二之间空了一行

这是段落 2 的效果

2.4 空行

该行仅有回车或仅有空格即为空行

2.5 对齐方式

<center>行中心对齐</center>
<p align="left">行左对齐</p>
<p align="right">行右对齐</p>

3 斜体、粗体、删除线、下划线、背景高亮

  • 代码

1. _斜体_ 或 _斜体_
2. **粗体**
3. **_加粗斜体_**
4. ~~删除线~~
5. <u>下划线</u>
6. ==背景高亮==
  • 样式展示

斜体  或 斜体粗体加粗斜体删除线下划线  背景高亮


4 超链接、页内链接、自动链接、注脚

4.1 超链接 - 行内式(适合只用一次)

  • 语法说明

    • [ ]里写链接文字,( )里写链接地址

    • ( )中的""中可以为链接指定 title 属性,title 属性可加可不加。title 属性的效果是鼠标悬停在链接上会出现指定的 title 文字,链接地址与 title 前有一个空格。

  • 代码

1. 欢迎访问 [如擎官网](http://www.rqimage.cn/)
2. 欢迎访问 [如擎官网](http://www.rqimage.cn/ "冯皓")
  • 显示效果

  1. 欢迎访问 如擎官网

  2. 欢迎访问 如擎官网

4.2 超链接 - 参考式(适合多次引用)

  • 参考式链接分为两部分:

1. 文中的写法:  
   [链接文字][链接标记]
2. 在文本的任意位置添加:  
   [链接标记]:链接地址
  • 显示效果
    我经常去的几个网站如擎B 站

4.3 注脚

  • 语法说明:
    在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。

  • 注意:
    经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经 Markdown 转换后,也会自动归类到文章的最后。

  • 代码

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperText Markup Language 超文本标记语言
  • 显示效果
    使用 Markdown[1]可以效率的书写文档, 直接转换成 HTML[2]


  • 脚注自动被搬运到最后面,请到文章末尾查看,脚注后方的链接可以直接跳转回到加注的地方。

4.4 锚点(页内超链接 如目录)

  • 说明
    锚点就是页内超链接,如目录,以及上文的脚注

  • 代码

1. 先定义一个锚(id)
  <span id="jump">Hello World</span>
2. 然后使用markdown的语法:
  [XXXX](#jump)

4.5 自动链接

  • 语法说明
    Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

  • 代码

&lt;http://example.com/&gt;  
&lt;address@example.com&gt;
  • 效果
    <http://example.com/>
    <address@example.com>


5 无序列表、有序列表、定义型列表

5.1 无序列表

使用 *+- 表示无序列表,可嵌套,第一层为实心圆,第二层为空心圆,第三层为实心方:

  • 代码

- 无序列表项 一

* 无序列表项 二

- 无序列表项 三
  • 效果

    • 无序列表项 一

    • 无序列表项 二

    • 无序列表项 三

5.2 有序列表

有序列表则使用数字接着一个英文句点,同样可嵌套:

  • 代码

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三
  • 效果

  1. 有序列表项 一

  2. 有序列表项 二

  3. 有序列表项 三

5.3 定义型列表

  • 语法说明
    定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。
    解释的写法:紧跟一个缩进(Tab)

  • 代码

: 轻量级文本标记语言(左侧有一个可见的冒号和一个 Tab 空格)
  • 效果
    MarkDown
    : 轻量级文本标记语言(左侧有一个可见的冒号和一个 Tab 空格)


6 插入图片

6.1 使用![]()方式 - 无法确定图片大小

  • 格式:

![图片Alt](图片地址 "图片Title")
  • 代码:

<center>  <!--开始居中对齐-->

![网络图片](http://suo.im/5L29qm "李信世冠皮肤")

![本地图片](云鹰飞将.jpg "QGhappy FLY")
<!-->本地图片无法显示故不展示<-->

</center> <!--结束居中对齐-->
  • 效果

网络图片

6.2 借用HTMLimg格式 - 能够设置图片大小、居中等

  • 代码

<center>
<img src='' width= height= alt='' align=''>
</center>
<!-->
src为文件路径或网址;
width为宽度;height为高度,建议不设宽度,高度设为1920,保证纵横比;
alt为图片未加载时显示文字;
align为对齐方式,如居中center,左left,右right
<-->
  • 示例

<center>
<img src='http://suo.im/5L29qm' width=300 alt='李信'>
</center>
  • 效果

李信

6.3 借用HTML<table>表格 - 实现同行多个图片

  • 代码

<table bordern="">
<tr>
   <td>行1列1内容</td>
   <td>行1列2内容</td>
</tr>
<tr>
   <td>行2列1内容</td>
   <td>行2列2内容</td>
</tr>
</table>
  • 实例

<table bordern="0">
<tr>
   <td><center><img src='http://suo.im/5L29qm' alt='李信'>行1列1</center></td>
   <td><center><img src='http://suo.im/5L29qm' alt='李信'>行1列2</center></td>
</tr>
<tr>
   <td><center><img src='http://suo.im/5L29qm' alt='李信'>行2列1</center></td>
   <td><center><img src='http://suo.im/5L29qm' alt='李信'>行2列2</center></td>
</tr>
</table>
  • 效果

李信行1列1

李信行1列2

李信行2列1

李信行2列2


7 多级引用

  • 说明 引用需要在被引用的文本前加上>符号和空格,允许多层嵌套,也允许只在整个段落的第一行最前面加上 >

  • 代码

> 请问 Markdwon 怎么用? - 小白
>
> > 自己看教程! - 愤青
> >
> > > 教程在哪? - 小白
  • 效果

    请问 Markdwon 怎么用? - 小白

    自己看教程! - 愤青

    教程在哪? - 小白


8 转义字符、字体、字号、颜色

8.1 转义字符

  • 转义字符:\

  • 转义范围:

    • \ 反斜杠

    • ` 反引号(ESC 下面的按钮)

    • * 星号

    • _ 下划线

    • {} 大括号

    • [] 中括号

    • () 小括号

    • # 井号

    • + 加号

    • - 减号

    • . 英文句号

    • ! 感叹号

8.2 字体、字号、颜色

  • 书写格式:<font 属性=" ">正文</font>

  • 属性内容:

    • 字体:face 如黑体

    • 字号:size 如 12

    • 颜色:color 如 red,或 16 进制字符色

  • 代码

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=red size=5>red</font>
<font color=#00ffff size=3>null</font>
  • 效果

    • 我是黑体字

    • 我是微软雅黑

    • 我是华文彩云

    • 黑体

    • red

    • null


9 块语法

9.1 内容目录

在段落中填写 [TOC] 以显示全文内容的目录结构。

  • 代码

    [TOC]

  • 效果
    见本文目录

9.2 代码块

9.2.1 行内式

  • 行内式 - 单个 使用``包围(ESC 下面的按钮)

  • 代码

    Python的`append()`方法是什么
    
  • 效果
    Python 的append()方法是什么

9.2.2 缩进式 - 多行

缩进 4 个空格或是 1 个制表符,一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

  • 代码

    import numpy as np
    import pandas as pd
    import matplotlib.pyplot as plt
    
  • 效果(好像没效果)
    import numpy as np
    import pandas as pd
    import matplotlib.pyplot as plt

9.2.3 用六个`包裹多行代码 - 最常用

  • 说明
    ``` ```的方式来包裹多行代码,在第一个```之后可以写上对应的代码语言(如 python,markdown,html),使关键词突出。

  • 代码

  • 1. ``` python 2. import numpy as np 3. import pandas as pd 4. import matplotlib.pyplot as plt 5. ```

  • 效果

import numpy as np
import pandas as pd
import matplotlib.pyplot as plt

9.3 Latex 公式

9.3.1 行内公式

  • 说明
    使用<span data-formula=" " aria-hidden="true">括起来

  • 代码

  质能守恒方程可以用一个很简洁的方程式 <span data-formula=" E = m c^2 " aria-hidden="true"></span>来表达。
  • 效果
    质能守恒方程可以用一个很简洁的方程式 来表达。

9.3.2 整行公式

  • 说明 使用<span data-formula="" aria-hidden="true"> <span data-formula="" aria-hidden="true">括起来

  • 代码

质能守恒方程可以用一个很简洁的方程式```blockformula_editor E = m c^2 ```来表达。
  • 效果
    质能守恒方程可以用一个很简洁的方程式blockformula_editor E = m c^2 来表达。


10 表格

  • 语法说明

    • 不管是哪种方式,均需满足以下要求:

      1. 第一行为表头;

      2. 第二行分隔表头和主体部分;

      3. 第三行开始每一行为一个表格行;

      4. 列于列之间用管道符|隔开;

      5. 原生方式的表格每一行的两边也要有管道符。

    • 第二行还可以为不同的列指定对齐方向。默认为左对齐:

      1. - 左对齐;

      2. :-: 中心对齐;

      3. -: 右对齐。

  • 代码

| 学号   | 姓名 | 序号 |
| ------ | ---- | ---- |
| 小明明 | 男   | 5    |
| 小红   | 女   | 79   |
| 小陆   | 男   | 192  |
  • 效果

学号

姓名

序号

小明明

5

小红

79

小陆

192


11 分隔线

  • 说明
    你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

  • 代码

---
---
---

---

---
  • 效果






12 HTML 原始码

在代码区块里面, &<> 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理。

13 特殊字符

特殊字符

描述

字符代码

 

空格

&emsp; &ensp; &nbsp;

<

小于号

&lt;

>

大于号

&gt;

&

和号

&amp;

¥

人民币

&yen;

©

版权

&copy;

®

注册商标

&reg;

°C

摄氏度

&deg;C

±

正负号

&plusmn;

×

乘号

&times;

÷

除号

&divide;

²

平方(上标 ²)

&sup2;

³

立方(上标 ³)

&sup3;

参考内容


  1. Markdown 是一种纯文本标记语言 ↩︎

  2. HyperText Markup Language 超文本标记语言 ↩︎


本文章使用limfx的vsocde插件快速发布